home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / WOTW13.ZIP / WOTW.DOC < prev    next >
Encoding:
Text File  |  1996-02-03  |  19.3 KB  |  440 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                       CorpSoft BBS (815) 886-9388                           ║
  4. ║                         3 Nodes - USR 28.8  v.34                            ║
  5. ║                                                                             ║
  6. ║                              WAR OF THE WORDS                               ║
  7. ║                                    v1.3                                     ║
  8. ║                                                                             ║
  9. ║                              MULTI-BBS Support                              ║
  10. ║           Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,          ║
  11. ║                UltraBBS, Telegard, TriTel, and Remote Access                ║
  12. ║                                                                             ║
  13. ║                               Copyright 1996                                ║
  14. ║                               by Robert Neal                                ║
  15. ║                             317 Hickory Avenue                              ║
  16. ║                            Romeoville, IL  60446                            ║
  17. ║                                                                             ║
  18. ╚═════════════════════════════════════════════════════════════════════════════╝
  19.  
  20.  
  21. War of the Words is released as SHAREWARE. You are granted a limited license 
  22. to evaluate the program. Try it out, if you continue to use it for more than 
  23. 30 days you are required to register the program.
  24.  
  25. To register the program send $15.00 along with your name and BBS name
  26. to: Robert Neal, 317 Hickory Avenue, Romeoville, IL 60446. See the file
  27. MAILER.TXT for additonal pricing information and special discounts
  28. available. You may also register ONLINE with Visa or MasterCard by
  29. calling the support BBS at (815) 886-9388. Simply type CHARGE at the menu.
  30.  
  31. Once you register War of the Words, you will be given your own unique 
  32. registration number. The BBS name supplied with payment will be the name 
  33. used to create your unique registration number.
  34.  
  35. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  36. WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  37. LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  38. PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND
  39. PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL
  40. DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  41.  
  42.  
  43. *PROGRAM DESCRIPTION*
  44.  
  45. War of the Words is a challenging word game. You are given 15 letter
  46. tiles of randomly selected letters. You then begin to find words,
  47. between 3 to 7 letters each, to play in the scoring grid. Each game is
  48. limited in time, configurable by the sysop. Scoring for each letter
  49. follows the rules of Scrabble. In addition, a multiplier bonus is
  50. added based on the length of the word (ie a 3 letter word is worth
  51. 3 times the base letter scoring, a 7 letter word is worth 7 times
  52. the base letter scoring).
  53.  
  54. To be fair to all players, War of the Words will randomly select
  55. letters consistent between games. All players in games will be
  56. given the same letter tiles in which to create words. For example,
  57. all players of game #1 will have the same letter tiles to play
  58. from. Other word games randomly select letters each game, but
  59. with the same letters players are able to compete on the same
  60. basis against other users.
  61.  
  62. A dictionary of over 40,000 words is included to validate words
  63. played. Words contained are based on the Official Scrabble Players
  64. Dictionary.
  65.  
  66. War of the Words will automatically reset the scoreboard at the start
  67. of each month, requiring no sysop maintenance after initial set-up.
  68.  
  69.  
  70. *PROGRAM FEATURES*
  71.  
  72.   -  Easy to install, includes configuration editor.
  73.   -  Requires no maintenance.
  74.   -  Ansi colors and display.
  75.   -  Terminates cleanly through exit code even on runtime error.
  76.   -  Automatically creates a top score listing suitable for inclusion
  77.      as a text/bulletin file for display within your BBS. Both an
  78.      ANSI and ASCII file is created.
  79.   -  Detects loss of carrier.
  80.   -  Sysop function keys to return to the board, chat mode, user stats,
  81.      increase/decrease time, etc.
  82.   -  Direct support for PCBoard, WildCat!, Gap, QBBS, RBBS,
  83.      Ultra BBS, Telegard, TriTel and Remote Access.
  84.   -  Support for baud rates up to 115,200
  85.   -  Support for COM1-15. Optional command line for non-standard IRQ's.
  86.   -  Supports PCBoard environment variables %PCBDRIVE% and %PCBDIR%
  87.   -  Support Fossil Drivers. A Fossil driver is not required to use the
  88.      program.
  89.   -  Fully Multi-Node compatible.
  90.   -  Support for multi-port digiboards, for use with PCBoard /M.
  91.   -  Yearly scoreboard with rolling 12 month top scores.
  92.   -  Optional "adopted by" banner to acknowledge users who contribute.
  93.      towards registration of the game.
  94.   -  Command line local play option to evaluate the program.
  95.   -  40,000+ word dictionary
  96.  
  97. As an encouragement to register War of the Words, the following options
  98. are not available until registered:
  99.     
  100.     - Games per day (games are limited to 3 per day)
  101.     - Make up games
  102.     - Adopted by option (since it's not yet registered, it can't be
  103.         adopted, right?).
  104.  
  105. All other aspects of operation are fully functional. 
  106.  
  107.  
  108.  
  109. *FIRST TIME OPERATIONS*
  110.  
  111. Simply create a directory for War of the Words and copy all files
  112. distributed with War of the Words to this directory. Additional data
  113. files will automatically be created the first time War of the Words is run.
  114.  
  115.  
  116. CONFIGURING THE PROGRAM
  117. Use the program WOTWCFG which is included with the distributed program to 
  118. edit the file WOTW.CFG. Below is the layout of this file:
  119.  
  120. C:\PCB\PCBOARD.SYS
  121. Corporate Headquarters
  122. Bob
  123. Neal
  124. 3
  125. 0
  126. NA
  127. 3
  128. 300
  129. Y
  130.  
  131.  
  132. Line 1 = Full pathname of your door file. Formats supported by this
  133.      program are: PCBOARD.SYS, USERS.SYS, DOOR.SYS, USERINFO.DAT,
  134.               CALLINFO.BBS, DORINFOx.DEF, SFDOORS.DAT and
  135.               GTUSER.BBS, DOOR.SYS, and TRIBBS.SYS. When using
  136.               USERINFO.DAT, DOOR.SYS  must be in the same
  137.               directory as USERINFO.DAT.
  138. Line 2 = BBS name
  139. Line 3 = Sysop First Name
  140. Line 4 = Sysop Last Name
  141. Line 5 = number of plays per day. I suggest a daily limit of 3 to 5,
  142.          but tailor to your own needs.
  143. Line 6 = Registration number. Leave as 0 if unregistered.
  144. Line 7 = You can place the name of the user who helped pay for the
  145.         registration of the door. Several sysops have specified that
  146.         users have paid the reigstration fee for War of the Words. You can
  147.         now place their name on this line and their name will be
  148.         proudly displayed at the end of the game so that others may
  149.         recognize their contribtion to the operation of your BBS.
  150.         Leave this blank or NA if you do not wish to use this
  151.         option.
  152. Line 8 = Maximum number of make up games per day. You can allow your
  153.         users to make up games lost because they were unable to 
  154.         call and play. Enter the number of GAMES (not days) you 
  155.         allow them to make up each day.
  156. Line 9 = Maximum number of seconds to be allowed per game. Recommend
  157.         300 seconds (5 minutes).
  158. Line10 = Enter "Y" if you want to have a penalty assessed against the
  159.         users score for incorrect, duplicate and invalid letter
  160.         selections. The penalty is 10 times the number of letters
  161.         in the word, ie KAT would be assessed a 30 point penalty.
  162.  
  163.  
  164. *EXECUTING PROGRAM*
  165.  
  166. To execute the program, enter the filename followed by the config file
  167. name (ie WOTW WOTW.CFG).
  168.  
  169. Additionally, all CorpSoft doors allow you to fully evaluate the
  170. program without the need to setting up the door and running it
  171. from your BBS (we don't know why all doors don't include this feature,
  172. being a sysop myself, it's a real hassle to evaluate some doors).
  173. If you are running the program from the command line, enter WOTW LOCAL.
  174. The default user name SysOp is used. This is good for testing
  175. but you should once play begins, execute the program from your BBS
  176. or consistantly run the game from the command line when you play.
  177.  
  178. You may also specify a non-standard IRQ. Put the IRQ number after the
  179. .CFG on the command line. For example: WOTW WOTW.CFG /5. This tells
  180. the program to use IRQ 5 instead of the standard IRQ.
  181.  
  182. You may also use the procedure above and create a variable IRQ so that
  183. you can pass the IRQ setting as: WOTW WOTW.CFG /%IRQ%
  184.  
  185. Some users may have had conflicts when using non-standard IRQ's on
  186. Novell/Netware systems. Novell seems to use the "/" character for
  187. parameter passing. You may not optionally use the "*" character instead
  188. of the "/", for example WOTW WOTW.CFG *%IRQ% is valid. Both "*" and
  189. "/" will work.
  190.  
  191.  
  192. *AUTOMATIC MAINTENANCE*
  193.  
  194. The program will automatically during the first play of each new month
  195. reset it's user file and top score listing. The previous months
  196. scoreboard will be renamed to WOTW.OLD and WOTWG.OLD. This can then 
  197. be included as a text file to display the previous months winners.
  198.  
  199. You should be aware of this so if you are starting a new game for the
  200. first time towards the end of the month, the game will automatically perform
  201. the maintenace come the first of the month.
  202.  
  203. As an option, you may pass the parameter "NEW" on the command line, for 
  204. example WOTW NEW. This will reset _all_ War of the Words data files,
  205. including the overall high scorer information. 
  206.  
  207.  
  208.  
  209. *FOSSIL DRIVER*
  210.  
  211. War of the Words includes support for FOSSIL drivers. This means that the
  212. program will work with Digiboard (for Wildcat M and PCBoard/M versions) 
  213. and other multi-port boards. To activate the Fossil driver support just 
  214. include /FD on the command line in your door batch file.
  215.  
  216.     For example: WOTW WOTW.CFG /FD
  217.  
  218. If no Fossil driver is available, War of the Words will display a message
  219. indicating such and exit cleanly.
  220.  
  221.  
  222. This documentation will not go into the mechanics of how you set-up a door
  223. program on your BBS. It is assumed that you have a working knowledge of
  224. how to complete this task. It would be impossible for me to explain how
  225. to install a door for all BBS programs supported by War of the Words.
  226.  
  227.  
  228. *SYSOP KEYS ACTIVE*
  229.  
  230. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  231.      written to DOOR.SYS and USERS.SYS
  232. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  233.      and/or written to DOOR.SYS and USERS.SYS
  234. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  235. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  236.      and/or written to DOOR.SYS and USERS.SYS
  237. F8    -  Returns the caller involuntarily to the BBS.
  238. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  239.      and/or written to DOOR.SYS and USERS.SYS
  240. F10   -  Activates SysOp CHAT mode within the DOOR.
  241. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  242. UP    -  Give the caller extra time while in the DOOR.  
  243. DN    -  Subtract time from the caller while in the DOOR. 
  244. HOME  -  HELP key for Status Line options.
  245. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  246. ALT-X -  PCBoard will exit after current caller logs off. Value is
  247.      passed to PCBoard. Not available on non-PCBoard systems.
  248.  
  249.  
  250. *MAKE UP DAYS OPTION (Registered version only)*
  251.  
  252. Many users will not participate in a game if they know they will be 
  253. unable to play each and every day. With the Make Up Days option, you can
  254. allow players to make up missed games (the number allowed per day is 
  255. defined by you). If you enter a 0, you will disable this option. Please 
  256. note that the value placed on this field in the .CFG file is the
  257. number of games, not days, you will allow the user to make up. 
  258.  
  259. As an example, if you allow 5 games per day, but allow 8 make up games, 
  260. the user will be able to play a maximum of 13 games on any single day. 
  261. If the user has played all games to date then the user will only be 
  262. allowed to play 5 games (as defined by you for number of plays per day).
  263.  
  264.  
  265. *ADOPTED BY OPTION (Registered version only)*
  266.  
  267. Many sysops are fortunate to have their users offer to register a door
  268. they enjoy playing. You can now give recognition to the user or users
  269. who assist in contributing to the registration of this program. Simply 
  270. enter their name(s) on the appropriate line in the configuration file.
  271.  
  272. When unregistered, the door will inform the user that they can adopt
  273. the door and refers them to ask you for details. You can give the
  274. user the registration form for them to send in if you'd like.
  275.  
  276. After the program is registered, each time a user quits the game a
  277. screen will be displayed informing other users who contributed towards
  278. the registration of the game. 
  279.  
  280. If you wish to disable this option, enter NA on the line in the 
  281. configuration file.
  282.  
  283.  
  284.  
  285. *TROUBLESHOOTING*
  286.  
  287. -  If you are running this Door on a 486 system and encounter an error
  288.    message "ERROR 6 - OVERFLOW ERROR" or you experience irratic Keyboard
  289.    Timeout messages, you may have to put the following in either your
  290.    AUTOEXEC.BAT file or in the batch file you use to call this program.
  291.  
  292.      SET NO87=ON
  293.  
  294.    If you are running on a 486 system with co-processor under DesqView, you
  295.    may alternately set Math Coprocessor in each window to YES.
  296.  
  297. -  If you encounter an ERROR 62 when the program first is loaded, this
  298.    will usually indicate that there is an error in your .CFG file. 
  299.    Recheck your .CFG file to verify the proper format (if you use the
  300.    WOTWCFG program you should never encounter this error).
  301.  
  302. -  An ERROR 70 message means you more than likely do not have SHARE
  303.    loaded. This is typically only required for multi-node systems.
  304.  
  305.  
  306. *MULTI-NODE OPERATION*
  307.  
  308. If you are running a multi-node BBS, there are two ways which you      
  309. can set-up War of the Words.
  310.     
  311.     1. Create a seperate configuration file for each node.
  312.        The only difference between the configuration files would
  313.        be the location of your BBS drop file. 
  314.     
  315.     2. You can use one configuration file for all nodes by 
  316.        using an environment variable. Both PCBoard and Wildcat
  317.        provide these automatically when running a door program.
  318.        For PCBoard, the environment variables are PCBDIR and PCBDRIVE.
  319.        You can then place the following on the first line of your
  320.        configuration file:
  321.         %PCBDRIVE%%PCBDIR%\PCBOARD.SYS
  322.        For Wildcat systems, it uses the variable WCNODEID, you can 
  323.        place the following on the first line of your configuration
  324.        file: 
  325.         C:\WC30\WCWORK\NODE%WCNODEID%\DOOR.SYS
  326.  
  327.        If you are running other BBS software, you should be able to
  328.        create these variables so that you can run the program as
  329.        explained above.
  330.  
  331.        Other BBS systems may also use these variables by
  332.        including the following either in your BBS batch or 
  333.        AUTOEXEC.BAT file:
  334.  
  335.         SET PCBDRIVE=C:            <- Drive letter of your BBS files
  336.         SET PCBDIR=\BBS            <- Path of your BBS files
  337.  
  338.  
  339. *CONTACT ME FOR SUPPORT*
  340.  
  341. If you encounter any problems you may contact me at CorpSoft BBS
  342. (815) 886-9388.
  343.  
  344. I can also be reached via the RIME network in the SYSOP, DOORS,
  345. SHAREWARE and BBS SOFTWARE conferences as well as the COMMON conference.
  346. I can also be reached via Internet e-mail at bob.neal@corpsoft.com. or
  347. via FIDO at 1:2235/886 (Bob Neal@1:2235/886).
  348.  
  349. If you have any suggestions for improvements for this program, please feel
  350. free to let me know. This game has included suggestions from users during
  351. beta testing.
  352.  
  353.  
  354. *DISTRIBUTION SITES*
  355.  
  356.    As always you can find the latest version of War of the Words available
  357.    for downloading from CorpSoft BBS.
  358.  
  359.    CorpSoft BBS   (815) 886-9388 (3 nodes with automatic ring-down,
  360.                   running USR 28800 v.everything)
  361.  
  362.    Also, I have a support conference on Salt Air BBS (home of PCBoard).
  363.    Join conference #71 (CorpSoft Support). I will always have the 
  364.    current version available for download on there as well as answer 
  365.    technical support question.
  366.  
  367. We also accept Visa and Mastercard. Register online with your Visa or
  368. Mastercard by calling CorpSoft BBS, simply type CHARGE at the main menu
  369. prompt.
  370.  
  371. User's with FIDO capabilities can FREQ the latest version of my software 
  372. from me at 1:2235/886. The magic names for my software are:
  373.     WOTW            War of the Words
  374.     KING            Kings are Wild Solitaire
  375.     CARD            Card Sharks
  376.     BOWL            BBS Bowling Solitaire
  377.     GOLF            Links Golf
  378.     ZWORD           Z-Wordz
  379.     CORPSOFT        All my shareware releases
  380.  
  381. Those with FTP capabilities can FTP my software from:
  382.     europa.com      cd /outoing/DOORS/corpsoft
  383.  
  384.  
  385. To further make it convenient for people to download my software, you can
  386. also login to my support BBS by enter CORPSOFT GUEST when prompted for 
  387. your name. You will not need to go through the new user information
  388. questionaire and will immediately be able to download my shareware. 
  389. Please note that if you wish to register online, you will need to
  390. set-up a user account so that your registration keys can be made available
  391. to you.
  392.  
  393.  
  394.  
  395. *VERSION HISTORY*
  396.  
  397. v1.3 - Found an error (egads!). If a player called just before midnight
  398.         and then entered the game after midnight they would be informed
  399.         they were out of time and kick them back to the BBS.
  400.        Revised the word dictionary files to account for revisions
  401.         in the latest version of the Official Scrabble Players
  402.         Dictionary (used as our source for valid words).
  403.        Once again I've rewritten the letter selection to pull a much
  404.         more randomized letter selection. Tore apart the routine and
  405.         started with a clean slate. I've tested the routine for a couple
  406.         of weeks and logged the letter selection then ran a program to
  407.         test the selection and found that the letters are being selected
  408.         on a pretty even basis. Fingers crossed, this should put this
  409.         issue to rest, but then I thought that before :0
  410.  
  411. v1.2 - With the new year I found that the yearly scoreboards displayed
  412.     an incorrect date for the December rollover information, the
  413.     date was shown as 12/96 instead of 12/95. Fixed. Also, the
  414.     incorrect yearly scoreboard information will be corrected the
  415.     first time that the "Y"early scoreboard is displayed within the
  416.     game.
  417.        Still having problems with poor letter selection. Seems that the
  418.     PC just doesn't generate a very random random number. Rewrote
  419.     routine which hopefully resolves the problem with too many
  420.     repeated letters showing up once and for all. Had four other
  421.     systems test the results all with positive results. If you
  422.     still have problems, let me know.
  423.  
  424. v1.1 - Added routine to continuously update the time left. Previous version
  425.     would only update time after entry of a word.
  426.        Rewrote the word lookup routine, now 300-400% faster. You'll notice
  427.     this especially for 6 and 7 letter word lookups.
  428.        Expanded the help function. I felt there was too much information
  429.     being shown on one screen. This is not broken up into several
  430.     different pages, each page selectable by the user.
  431.        Added option at start of game where user can view the scoreboard
  432.     before starting to play the game and before timer starts running.
  433.        Modified the text display boxes to include the box outline so that
  434.     non-color users can easily view text displays.
  435.        Revised letter selection routine to ensure that at least 2 vowels
  436.     are always selected.
  437.        Several other minor display and internal changes.
  438.  
  439. v1.0 - Initial Release
  440.